home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / comm / fido / RFS275.lha / DOCS / RFS.doc < prev   
Text File  |  1994-07-20  |  9KB  |  218 lines
  1. ;$VER: RFS Doc The WPL Remote Freq Server               Williamson  55.10
  2.  
  3.         RFS  is  included  in  the  distribution  of  the  Shelter Mailer
  4.         ,Porticus. Freqable under the magic name: SHELTER
  5.         Full archive RFS.LHA is updated nightly on 1:167/104 (14.4bps)
  6.         and 1:167/151 (Zyxel)
  7.  
  8.     o NODELIST SUPPORT via WPL for either Igen or TrapList
  9.     o Xferq.library and LogProc support for WPL mailers.
  10.     o allows  use of TransAmiga *.desc description files instead of file
  11.       notes.
  12.     o allows use of DLG FD description files instead of file notes
  13.     o Supports GRAB, the WPL File Request Server for Humans
  14.     0 Reward for CallBack Verified GRAB users
  15.     o Supports WfreqIt, the WPL File Request Forwarder
  16.     o Creates  FSC-0039  Mail  Packets  using ROOF's FTSC Registered
  17.       Product Code.
  18.     o Sends text file instead of mail packet for GRAB requesters
  19.     o Supports FTS-0006 Update requests in addition to the new
  20.       RFS/QuickSilver/FreqMate   human   readable  update  request  (HRF)
  21.       format.
  22.         +/-unix_timestamp       <------ fts-0006
  23.         +/-Uyymmdd[hhmmss]      <------ RFS, QS, FreqMate
  24.     o 5D Addressing and Multi-Line through the magic of WPL.
  25.     o Includes the fast freq list search utility Fsearch, 
  26.       written by Frederic Morin for RFS.
  27.     o MAGIC filename support.
  28.     o PASSWORD  protection  on  file  areas,  specific  files  and Magic
  29.       filenames.
  30.       Format: FILENAME !PASSWORD
  31.     o ACCOUNTING  support keeps track of the number requests, the number
  32.       of files sent and the number of bytes sent to each requesting node.
  33.     o FIRST TIME LETTER for callers.
  34.     o PERSONAL  message  for  callers  can be left by sysop which wil be
  35.       included in response file on next call.
  36.     o Buffered access to either WPL Log or own logfile for result
  37.       statistics.
  38.     o Uses WPL Log for progress monitoring.
  39.     o Uses  freq  listing  with  full PASSWORD and MAGIC name support as
  40.       created  by  RFSfreqlist,  Wfilelist,  FileMGR,  GKupload and other
  41.       wnotify/xfreqsh filelist generators.
  42.     o NO File I/O during processing other than reading the REQ,
  43.       accounting data, writing the response message  and searching
  44.       the FREQ.LST. Virtually All writes to disk are buffered and
  45.       and deferred until after requested files are queued.
  46.  
  47.     RFS  is  based  upon  the  last  source-released  version Roger Clark's
  48. QuickSilver  File  Request  Handler and has all the same features, but also
  49. has  additional ones as outlined above.  Although more than 60% of the code
  50. is  original,  certain  QS procedures have been optimized and are used with
  51. thanks  to Roger.  Roger and I have an ongoing code exchange arrangement in
  52. an effort to provide standardization and optimization for the users of both
  53. packages.
  54.  
  55.  Configuration:
  56.  
  57.     Nodelist flag should be set to XX.
  58.  
  59.     All configuration options are in RFS.cfg.  The only other external file
  60. required are the xfreqsh compatible list of freqable files.
  61.  
  62.  Freq list:
  63.     The freq list is in the format:
  64.     request_name [!password] fullpathname
  65.  
  66.     RFSfreqlist.rexx,  Wfilelist.rexx  and  Falcon  FileMGR.rexx all create
  67. such  a  list,  with password, magic name and auto fullpath update support.
  68. Other  xfreqsh  freq  list  creators  such  as  GKupload  and  other may be
  69. compliant also.
  70.  
  71.     For DLG systems, this script by Denis Turcotte creates the freq list:
  72.  
  73.  List File:(?|??|???|????)/~(enterarea.txt|POINTERS.FILE|User.file|.info|*.fd|File.dat) FILES NOHEAD LFORMAT "%N %F%N" to t:flist
  74.  sort t:flist t:flist
  75.  join cfg:magic.lst t:flist as cfg:FREQ.LST
  76.  delete t:flist QUIET
  77.  
  78.  WPL usage:
  79.  
  80.     Due  to  the  adoption  of  RFS  as  the  freq handler for the Roof and
  81. Porticus  Shelter Mailers, the config option 'wplport' was removed from the
  82. config file and becomes the command line parameter, wplportbasename.
  83.     wplportbasename is the WSC-compliant basename of the mailer slave port,
  84. excluding line.  RFS will build the LogProc LogGroup from this as follows:
  85.  
  86.             lower(wplport)"wpl"$(line)
  87.  
  88.     so if wplport="PORTICUS", and line=1, the LogGroup porticuswpl1 will be
  89. addressed. 
  90.  
  91.  run >NIL: Rx RFS $(wplportbasename) $(line) $(baud) $(host.address) $(infile) $(listed) $(remote.address) $(remote.sysop)
  92.  
  93.      For  68000  or heavily loaded systems, a utility to hold the mailer is
  94. included.  It is recommeded that the above be changed to:
  95.  
  96.  run >NIL: Rx STARTRFS $(wplportbasename) $(line) $(baud) $(host.address) $(infile) $(listed) $(remote.address) $(remote.sysop)
  97.  
  98.     wplportbasename - basename of mailer slave port    
  99.     Line            - modem line for request
  100.     Baud            - modem<->modem bps
  101.     host_address    - 5d address of system running RFS
  102.     InFile          - fullpath of REQ file
  103.     Listed          - 0 = not found in nodelist, 1=found
  104.     remote_address  - 5d address of requester
  105.     remote_sysop    - name of requester (from wazoo or emsi or nodelist lookup)
  106.  
  107.  
  108.  GRAB.wplrx usage:
  109.     Address "REXX" RFS wplportbasename line baud HOST.ADDRESS reqname 0 username'#0:0/0.0' username
  110.  
  111.     Note that GRAB user's byte limits are different than those for mailers.
  112. A CallBack verified GRAB user will be permitted 100*baud bytes.
  113.  
  114.  Update Requests:
  115.  
  116.     The  FTS-0006  update  request  specification was written, as with most
  117. other  FTSs,  to  document  existing  practice  with  a particular piece of
  118. software.   However,  it  is  obviously  NOT  user friendly, as it requires
  119. conversion  between  'human'  time  and  unix  time.   While this is easily
  120. accomplished  by  programs which create .REQ files, it is not so simple for
  121. people who write them manually.
  122.  
  123.     Therefore, it was proposed that a new "UPDATE" type be implemented that
  124. can  be  used  by humans.  QuickSIlver and FreqMate now include support for
  125. this format.
  126.  
  127.     This is SIMPLY: 
  128.             +/-Uyymmdd[hhmmss]
  129.     Where the time is optional and GMT offset is NOT taken into account.
  130.  
  131.     Both forms (date and datetime) are accepted by RFS.
  132.  
  133.     It  has  been suggested in the NET_DEV echo that the Nodelist FLAG "XU"
  134. be used to indicate this type of update request handling.
  135.  
  136.     In  addition,  FTS-0006  standard  unix  timestamp  update requests are
  137. processed.
  138.  
  139.  WildCards and Magic Request Names:
  140.     
  141.     RFS  can  use  AmigaDOS  pattern matching facilities.  This SHOULD mean
  142. that all pattern matching specifications should work, although this has NOT
  143. been tested.  This also means that the underscore bug of AmigaDOS's pattern
  144. matching  unfortunately affects operations.  If a fullpath name contains an
  145. underscore  preceeding  the  PATTERN,  it  may  be  considered  a  match by
  146. AmigaDOS.
  147.  
  148.     Two configuration options affect how wildcards are processed:
  149.         MatchFirst  - if TRUE, only the first file matching is send
  150.         MultiMagic  - if TRUE, multiple files are send for MAGIC names
  151.  
  152.  WPL Installation:
  153.  
  154.     You  will need to set the 'listed' variable on nodelist lookup.  This
  155. is an extract from ROOF.WPL showing how I do it.
  156.  
  157.         Set systemcmd "$(lookup) $(remote.address) nodelist: $(line) "
  158.         SubJump dosys
  159.         Cmp $(RC) 0
  160.         TrueJump wazoo.4.1
  161.             Set listed 0
  162.             PutLog "$<time> $(line) $(remote.address) not in NodeList - Lookup:$(RC) $(listed)"
  163.             ;If we want to accept listed nodes only, then we would do this here:
  164.             ;Jump badwazoo
  165.   wazoo.4.1:
  166.     ; node was listed!
  167.     Set listed 1
  168.     CmpI ${$(line).password} ""
  169.     TrueJump wazoo_nopassword
  170.         ; there IS a password
  171.         CmpI ${$(line).password} $(remote.password)
  172.         TrueJump wazoo_password
  173.             PutLog "$<time> $(line) Password Error: His:[$(remote.password)] Ours:[${$(line).password}]"
  174.   badwazoo:
  175.             PutLog "$<time> $(line) BADWAZOO Host:$(host.address)"
  176.             Set RC FALSE
  177.             Return
  178.  
  179.  ....and  this  is  an  extract showing how it is executed in ROOF.  Your
  180. implementation may vary.
  181.  
  182.   filenotify:
  183.     ; RFS wpl/xfreq File Request Server
  184.     Set systemcmd "run >NIL: Rx ${REXXDIR}/RFS $(wplport) $(line) $(host.address) $(infile) $(listed) $(remote.address) $(remote.sysop)"
  185.     ; for 68000 system
  186.     ;Set systemcmd "run >NIL: Rx ${REXXDIR}/STARTRFS $(wplport) $(line) $(host.address) $(infile) $(listed) $(remote.address) $(remote.sysop)"
  187.  
  188.     Pattern $(remfile) #?.REQ
  189.     FalseJump filenotify.2
  190.         Set RC $(host.freq)
  191.         TrueJump dosys
  192.             PutLog "$<time> $(line) $(remote.address) ignored WaZoo No-FREQS"
  193.             ; We might just want to hang up on this guy :)
  194.             ; or send him a nasty message
  195.             ; Jump filenotify.2
  196.  
  197.  .....
  198.  
  199.   ; execute an external command  
  200.   dosys:
  201.     ; save current state
  202.     Set tstate $(state) state "EXTERNAL"
  203.     System $(systemcmd)
  204.     ; restore previous state
  205.     Set state $(tstate)
  206.     Clear systemcmd tstate
  207.   Return
  208.  
  209.  
  210.  Bugs:
  211.  
  212.     RFS  is  permanently in Beta Test stage, and may still have some bugs
  213. to  be  found.  If you experience any problems , PLEASE send me a NetMail
  214. at 1:167/104 or leave me feedback with the NOTE command at 1-514-696-6632
  215. explaining the problem.
  216.  
  217.  
  218.